home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / mdl10.zoo / mdl.l < prev    next >
Text File  |  1993-06-06  |  4KB  |  99 lines
  1.  
  2. NAME
  3.     mdl - display DL animations in monochrome ST
  4.  
  5. SYNOPSIS
  6.     mdl  [-v]  [-h]  [-s]  [-z]  [-r  fps]  [-b beta] [-n noise] [-i
  7.     intens] [file]
  8.  
  9. DESCRIPTION
  10.     mdl reads a file in DL format and displays the animation in that
  11.     file on a monochrome (only) Atari ST.  The DL file is read  from
  12.     either the  standard  input  or the specified file.  The program
  13.     runs on monochrome 640 by 400 displays only.
  14.  
  15.     Once  the  program  starts,  it  should  NOT  be  killed with ^C
  16.     (because  there  is  no  signal  handler  to  catch ^C and reset
  17.     screens).  After  the  animation  starts, any key will cause the
  18.     program to exit.
  19.  
  20. OPTIONS
  21.     The following command line options are recognized:
  22.  
  23.     -v    Verbose.  Print progress info to stdout  while  building
  24.         the images.
  25.  
  26.     -h    Print help info and exit.
  27.  
  28.     -s    Single (dithered)  image.    Do  not  set  up  the three
  29.         "flicker" images for each frame.  Speeds  up  setup  but
  30.         not playback.
  31.  
  32.     -z    If the animation is in medium format (160 x 100) it will
  33.         be zoomed up to large format (320 x 200).  If the anima-
  34.         tion is in large format this switch will be ignored.
  35.  
  36.     -r fps
  37.         Determines  the  rate  of  the animation, i.e., how many
  38.         frames per second that should be displayed.  The minimum
  39.         is 1 and the default is 25.  The maximum  on  an  ST  is
  40.         probably about 100.
  41.  
  42.     -b beta
  43.         Apply a  Laplace  filter to the image.  Tends to sharpen
  44.         up the image.  Values for beta start at 0 and  increase.
  45.         A  value  of  0  means  do not apply the filter (same as
  46.         omitting the -b switch).  A value of 4 is usually good.
  47.  
  48.     -n noise
  49.         Add an amount of random noise to the images.   Tends  to
  50.         help some flickered images.  Values for noise range from
  51.         0 to 255.    A value of 0 means no noise.  A value of 10
  52.         is usually good.
  53.  
  54.     -i intens
  55.         Increase (or decrease) the intensity of every  pixel  by
  56.         this amount.   intens  range from -255 to 255.  Adjusted
  57.         values will be bounded by 0 and 255.
  58.  
  59. EXAMPLES
  60.     Most DL files I have seen run best between 8 and 15  frames  per
  61.     second.  mdl is fairly accurate in the frame rate (though it was
  62.     only clocked at 1 fps).
  63.  
  64.     Display the animation foo.dl at 25 frames per second.
  65.  
  66.         mdl foo.dl
  67.  
  68.     Display  the  animation  fie.dl,  zoomed  to large format, at 12
  69.     frames per second.
  70.  
  71.         mdl -z -r 12 fie.dl
  72.  
  73. BUGS
  74.     None that I have found.  However, the program is a one day hack:
  75.     it uses Setscreen(2x) to rapidly  switch  between  images.    It
  76.     probably  won't run on a color system (without hacking the color
  77.     palette) and it won't run on any display  that  is  not  640  by
  78.     400.  You get what you pay for!
  79.  
  80.     The  program  has had limited testing (only a few .dl files were
  81.     available) with only version 2 medium format files.
  82.  
  83.     Report  bugs  to  rosenkra@convex.com.  The other  authors won't
  84.     know what you are talking about.
  85.  
  86. AUTHOR
  87.     Bill Rosenkranz <rosenkra@convex.com> using flicker code from my
  88.     MGIF  program  (which  was  based  on  code  by  Klaus  Pedersen
  89.     <micro@imada.dk>).
  90.  
  91.     Jonas Yngvesson <jonas-y@isy.liu.se> for the X Windows xdl.
  92.  
  93.     The   program   is   derived  from  dltogl  by  George  Phillips
  94.     <phillips@cs.ubc.ca>
  95.  
  96.     The suggestion (and code) to allow the user to set the animation
  97.     rate (in xdl) came from Per Beremark <per.beremark@telelogic.se>
  98.  
  99.